<html>
<head><meta charset="utf-8"><title>warning sections in rustdoc: #79677 · rustdoc · Zulip Chat Archive</title></head>
<h2>Stream: <a href="https://rust-lang.github.io/zulip_archive/stream/266220-rustdoc/index.html">rustdoc</a></h2>
<h3>Topic: <a href="https://rust-lang.github.io/zulip_archive/stream/266220-rustdoc/topic/warning.20sections.20in.20rustdoc.3A.20.2379677.html">warning sections in rustdoc: #79677</a></h3>

<hr>

<base href="https://rust-lang.zulipchat.com">

<head><link href="https://rust-lang.github.io/zulip_archive/style.css" rel="stylesheet"></head>

<a name="218894463"></a>
<h4><a href="https://rust-lang.zulipchat.com#narrow/stream/266220-rustdoc/topic/warning%20sections%20in%20rustdoc%3A%20%2379677/near/218894463" class="zl"><img src="https://rust-lang.github.io/zulip_archive/assets/img/zulip.svg" alt="view this post on Zulip" style="width:20px;height:20px;"></a> Joshua Nelson <a href="https://rust-lang.github.io/zulip_archive/stream/266220-rustdoc/topic/warning.20sections.20in.20rustdoc.3A.20.2379677.html#218894463">(Dec 04 2020 at 21:38)</a>:</h4>
<blockquote>
<p>For me it's another debate. In the end, we still want to generate his HTML which needs to be present before we even add the syntax extension. I think it's two different issues.</p>
</blockquote>
<p><span class="user-mention" data-user-id="210316">@GuillaumeGomez</span> this misses my point - if we add this CSS, people will immediately start using the HTML class</p>



<a name="218894500"></a>
<h4><a href="https://rust-lang.zulipchat.com#narrow/stream/266220-rustdoc/topic/warning%20sections%20in%20rustdoc%3A%20%2379677/near/218894500" class="zl"><img src="https://rust-lang.github.io/zulip_archive/assets/img/zulip.svg" alt="view this post on Zulip" style="width:20px;height:20px;"></a> Joshua Nelson <a href="https://rust-lang.github.io/zulip_archive/stream/266220-rustdoc/topic/warning.20sections.20in.20rustdoc.3A.20.2379677.html#218894500">(Dec 04 2020 at 21:38)</a>:</h4>
<p>if you want to add this you should add a feature gate for the <code>rustdoc-warning</code> CSS class, which sounds really painful to do, you'd need a full HTML parser</p>



<a name="218894606"></a>
<h4><a href="https://rust-lang.zulipchat.com#narrow/stream/266220-rustdoc/topic/warning%20sections%20in%20rustdoc%3A%20%2379677/near/218894606" class="zl"><img src="https://rust-lang.github.io/zulip_archive/assets/img/zulip.svg" alt="view this post on Zulip" style="width:20px;height:20px;"></a> GuillaumeGomez <a href="https://rust-lang.github.io/zulip_archive/stream/266220-rustdoc/topic/warning.20sections.20in.20rustdoc.3A.20.2379677.html#218894606">(Dec 04 2020 at 21:40)</a>:</h4>
<p>Is that an issue? The problem they were talking about was about the syntax extension, not the CSS itself. But maybe I completely missed the point. It's friday evening after all XD</p>



<a name="218894685"></a>
<h4><a href="https://rust-lang.zulipchat.com#narrow/stream/266220-rustdoc/topic/warning%20sections%20in%20rustdoc%3A%20%2379677/near/218894685" class="zl"><img src="https://rust-lang.github.io/zulip_archive/assets/img/zulip.svg" alt="view this post on Zulip" style="width:20px;height:20px;"></a> Joshua Nelson <a href="https://rust-lang.github.io/zulip_archive/stream/266220-rustdoc/topic/warning.20sections.20in.20rustdoc.3A.20.2379677.html#218894685">(Dec 04 2020 at 21:40)</a>:</h4>
<p>now I'm mostly ok with landing another syntax (e.g. WARNING:) and having <code>class="rustdoc-warning"</code> work as a side effect, but the difference is that <code>rustdoc-warning</code> wouldn't be stable</p>



<a name="218894701"></a>
<h4><a href="https://rust-lang.zulipchat.com#narrow/stream/266220-rustdoc/topic/warning%20sections%20in%20rustdoc%3A%20%2379677/near/218894701" class="zl"><img src="https://rust-lang.github.io/zulip_archive/assets/img/zulip.svg" alt="view this post on Zulip" style="width:20px;height:20px;"></a> Joshua Nelson <a href="https://rust-lang.github.io/zulip_archive/stream/266220-rustdoc/topic/warning.20sections.20in.20rustdoc.3A.20.2379677.html#218894701">(Dec 04 2020 at 21:40)</a>:</h4>
<p>right now we've documented that the CSS class will never change and is part of the stability guarentees</p>



<a name="218894747"></a>
<h4><a href="https://rust-lang.zulipchat.com#narrow/stream/266220-rustdoc/topic/warning%20sections%20in%20rustdoc%3A%20%2379677/near/218894747" class="zl"><img src="https://rust-lang.github.io/zulip_archive/assets/img/zulip.svg" alt="view this post on Zulip" style="width:20px;height:20px;"></a> GuillaumeGomez <a href="https://rust-lang.github.io/zulip_archive/stream/266220-rustdoc/topic/warning.20sections.20in.20rustdoc.3A.20.2379677.html#218894747">(Dec 04 2020 at 21:41)</a>:</h4>
<p>Ok, I'll write what I understood, you'll tell me how wrong/right I am :p</p>



<a name="218895137"></a>
<h4><a href="https://rust-lang.zulipchat.com#narrow/stream/266220-rustdoc/topic/warning%20sections%20in%20rustdoc%3A%20%2379677/near/218895137" class="zl"><img src="https://rust-lang.github.io/zulip_archive/assets/img/zulip.svg" alt="view this post on Zulip" style="width:20px;height:20px;"></a> GuillaumeGomez <a href="https://rust-lang.github.io/zulip_archive/stream/266220-rustdoc/topic/warning.20sections.20in.20rustdoc.3A.20.2379677.html#218895137">(Dec 04 2020 at 21:45)</a>:</h4>
<p>So, this PR adds the possibility to have codeblocks added and the associated CSS class. We checked with docs-rs to prevent CSS class conflicts. On that part, it seems all good.</p>
<p>We then asked opinions from rustdoc users, they said that using HTML directly was not nice and suggested to extend doc comments syntax. So once this syntax extension is decided, we'll still need to generate the <code>&lt;div class="rustdoc-warning"&gt;</code> element.</p>
<p>But where I'm lost, it's that you seem to say that if we don't know about the doc comment syntax extension, we can't add the <code>&lt;div class="rustdoc-warning"&gt;</code>. To be clear: this HTML doesn't require anything on our side. We declared the CSS class and made it work only on <code>&lt;div&gt;</code>. It doesn't exclude the syntax extension at all. Which is why I don't understand what's troubling you</p>



<a name="218895320"></a>
<h4><a href="https://rust-lang.zulipchat.com#narrow/stream/266220-rustdoc/topic/warning%20sections%20in%20rustdoc%3A%20%2379677/near/218895320" class="zl"><img src="https://rust-lang.github.io/zulip_archive/assets/img/zulip.svg" alt="view this post on Zulip" style="width:20px;height:20px;"></a> Joshua Nelson <a href="https://rust-lang.github.io/zulip_archive/stream/266220-rustdoc/topic/warning.20sections.20in.20rustdoc.3A.20.2379677.html#218895320">(Dec 04 2020 at 21:47)</a>:</h4>
<p>what troubles me is that this <em>stabilizes</em> the CSS class</p>



<a name="218895331"></a>
<h4><a href="https://rust-lang.zulipchat.com#narrow/stream/266220-rustdoc/topic/warning%20sections%20in%20rustdoc%3A%20%2379677/near/218895331" class="zl"><img src="https://rust-lang.github.io/zulip_archive/assets/img/zulip.svg" alt="view this post on Zulip" style="width:20px;height:20px;"></a> Joshua Nelson <a href="https://rust-lang.github.io/zulip_archive/stream/266220-rustdoc/topic/warning.20sections.20in.20rustdoc.3A.20.2379677.html#218895331">(Dec 04 2020 at 21:47)</a>:</h4>
<p>does any other part of rustdoc explicitly say it generates HTML like that?</p>



<a name="218895339"></a>
<h4><a href="https://rust-lang.zulipchat.com#narrow/stream/266220-rustdoc/topic/warning%20sections%20in%20rustdoc%3A%20%2379677/near/218895339" class="zl"><img src="https://rust-lang.github.io/zulip_archive/assets/img/zulip.svg" alt="view this post on Zulip" style="width:20px;height:20px;"></a> GuillaumeGomez <a href="https://rust-lang.github.io/zulip_archive/stream/266220-rustdoc/topic/warning.20sections.20in.20rustdoc.3A.20.2379677.html#218895339">(Dec 04 2020 at 21:47)</a>:</h4>
<p>Well, we need the CSS class in any case, no?</p>



<a name="218895349"></a>
<h4><a href="https://rust-lang.zulipchat.com#narrow/stream/266220-rustdoc/topic/warning%20sections%20in%20rustdoc%3A%20%2379677/near/218895349" class="zl"><img src="https://rust-lang.github.io/zulip_archive/assets/img/zulip.svg" alt="view this post on Zulip" style="width:20px;height:20px;"></a> Joshua Nelson <a href="https://rust-lang.github.io/zulip_archive/stream/266220-rustdoc/topic/warning.20sections.20in.20rustdoc.3A.20.2379677.html#218895349">(Dec 04 2020 at 21:47)</a>:</h4>
<p>what does this mean for the JSON backend?</p>



<a name="218895363"></a>
<h4><a href="https://rust-lang.zulipchat.com#narrow/stream/266220-rustdoc/topic/warning%20sections%20in%20rustdoc%3A%20%2379677/near/218895363" class="zl"><img src="https://rust-lang.github.io/zulip_archive/assets/img/zulip.svg" alt="view this post on Zulip" style="width:20px;height:20px;"></a> Joshua Nelson <a href="https://rust-lang.github.io/zulip_archive/stream/266220-rustdoc/topic/warning.20sections.20in.20rustdoc.3A.20.2379677.html#218895363">(Dec 04 2020 at 21:47)</a>:</h4>
<p>what does this mean if someone writes a PDF viewer based on the JSON backend?</p>



<a name="218895379"></a>
<h4><a href="https://rust-lang.zulipchat.com#narrow/stream/266220-rustdoc/topic/warning%20sections%20in%20rustdoc%3A%20%2379677/near/218895379" class="zl"><img src="https://rust-lang.github.io/zulip_archive/assets/img/zulip.svg" alt="view this post on Zulip" style="width:20px;height:20px;"></a> GuillaumeGomez <a href="https://rust-lang.github.io/zulip_archive/stream/266220-rustdoc/topic/warning.20sections.20in.20rustdoc.3A.20.2379677.html#218895379">(Dec 04 2020 at 21:47)</a>:</h4>
<p>the JSON backend doesn't (shouldn't?) care about that</p>



<a name="218895386"></a>
<h4><a href="https://rust-lang.zulipchat.com#narrow/stream/266220-rustdoc/topic/warning%20sections%20in%20rustdoc%3A%20%2379677/near/218895386" class="zl"><img src="https://rust-lang.github.io/zulip_archive/assets/img/zulip.svg" alt="view this post on Zulip" style="width:20px;height:20px;"></a> Joshua Nelson <a href="https://rust-lang.github.io/zulip_archive/stream/266220-rustdoc/topic/warning.20sections.20in.20rustdoc.3A.20.2379677.html#218895386">(Dec 04 2020 at 21:47)</a>:</h4>
<p>the CSS should be an implemnetation detail, not documented</p>



<a name="218895408"></a>
<h4><a href="https://rust-lang.zulipchat.com#narrow/stream/266220-rustdoc/topic/warning%20sections%20in%20rustdoc%3A%20%2379677/near/218895408" class="zl"><img src="https://rust-lang.github.io/zulip_archive/assets/img/zulip.svg" alt="view this post on Zulip" style="width:20px;height:20px;"></a> Joshua Nelson <a href="https://rust-lang.github.io/zulip_archive/stream/266220-rustdoc/topic/warning.20sections.20in.20rustdoc.3A.20.2379677.html#218895408">(Dec 04 2020 at 21:47)</a>:</h4>
<p><span class="user-mention silent" data-user-id="210316">GuillaumeGomez</span> <a href="#narrow/stream/266220-rustdoc/topic/warning.20sections.20in.20rustdoc/near/218895379">said</a>:</p>
<blockquote>
<p>the JSON backend doesn't (shouldn't?) care about that</p>
</blockquote>
<p>why not? That seems like a great thing to show in the documentation, even in other formats</p>



<a name="218895476"></a>
<h4><a href="https://rust-lang.zulipchat.com#narrow/stream/266220-rustdoc/topic/warning%20sections%20in%20rustdoc%3A%20%2379677/near/218895476" class="zl"><img src="https://rust-lang.github.io/zulip_archive/assets/img/zulip.svg" alt="view this post on Zulip" style="width:20px;height:20px;"></a> GuillaumeGomez <a href="https://rust-lang.github.io/zulip_archive/stream/266220-rustdoc/topic/warning.20sections.20in.20rustdoc.3A.20.2379677.html#218895476">(Dec 04 2020 at 21:48)</a>:</h4>
<p>yes and if we stick to markdown, the problem doesn't even exist</p>



<a name="218895513"></a>
<h4><a href="https://rust-lang.zulipchat.com#narrow/stream/266220-rustdoc/topic/warning%20sections%20in%20rustdoc%3A%20%2379677/near/218895513" class="zl"><img src="https://rust-lang.github.io/zulip_archive/assets/img/zulip.svg" alt="view this post on Zulip" style="width:20px;height:20px;"></a> Joshua Nelson <a href="https://rust-lang.github.io/zulip_archive/stream/266220-rustdoc/topic/warning.20sections.20in.20rustdoc.3A.20.2379677.html#218895513">(Dec 04 2020 at 21:49)</a>:</h4>
<p>I don't follow, sorry</p>



<a name="218895647"></a>
<h4><a href="https://rust-lang.zulipchat.com#narrow/stream/266220-rustdoc/topic/warning%20sections%20in%20rustdoc%3A%20%2379677/near/218895647" class="zl"><img src="https://rust-lang.github.io/zulip_archive/assets/img/zulip.svg" alt="view this post on Zulip" style="width:20px;height:20px;"></a> GuillaumeGomez <a href="https://rust-lang.github.io/zulip_archive/stream/266220-rustdoc/topic/warning.20sections.20in.20rustdoc.3A.20.2379677.html#218895647">(Dec 04 2020 at 21:50)</a>:</h4>
<p>sorry, not good at explaining</p>



<a name="218895668"></a>
<h4><a href="https://rust-lang.zulipchat.com#narrow/stream/266220-rustdoc/topic/warning%20sections%20in%20rustdoc%3A%20%2379677/near/218895668" class="zl"><img src="https://rust-lang.github.io/zulip_archive/assets/img/zulip.svg" alt="view this post on Zulip" style="width:20px;height:20px;"></a> GuillaumeGomez <a href="https://rust-lang.github.io/zulip_archive/stream/266220-rustdoc/topic/warning.20sections.20in.20rustdoc.3A.20.2379677.html#218895668">(Dec 04 2020 at 21:50)</a>:</h4>
<p>you can already use html directly with classes specific to rustdoc</p>



<a name="218895711"></a>
<h4><a href="https://rust-lang.zulipchat.com#narrow/stream/266220-rustdoc/topic/warning%20sections%20in%20rustdoc%3A%20%2379677/near/218895711" class="zl"><img src="https://rust-lang.github.io/zulip_archive/assets/img/zulip.svg" alt="view this post on Zulip" style="width:20px;height:20px;"></a> GuillaumeGomez <a href="https://rust-lang.github.io/zulip_archive/stream/266220-rustdoc/topic/warning.20sections.20in.20rustdoc.3A.20.2379677.html#218895711">(Dec 04 2020 at 21:51)</a>:</h4>
<p>if you use JSON, maybe you want to only list your items or have another renderer, no idea</p>



<a name="218895718"></a>
<h4><a href="https://rust-lang.zulipchat.com#narrow/stream/266220-rustdoc/topic/warning%20sections%20in%20rustdoc%3A%20%2379677/near/218895718" class="zl"><img src="https://rust-lang.github.io/zulip_archive/assets/img/zulip.svg" alt="view this post on Zulip" style="width:20px;height:20px;"></a> Joshua Nelson <a href="https://rust-lang.github.io/zulip_archive/stream/266220-rustdoc/topic/warning.20sections.20in.20rustdoc.3A.20.2379677.html#218895718">(Dec 04 2020 at 21:51)</a>:</h4>
<p><span class="user-mention silent" data-user-id="210316">GuillaumeGomez</span> <a href="#narrow/stream/266220-rustdoc/topic/warning.20sections.20in.20rustdoc/near/218895668">said</a>:</p>
<blockquote>
<p>you can already use html directly with classes specific to rustdoc</p>
</blockquote>
<p>you can?</p>



<a name="218895728"></a>
<h4><a href="https://rust-lang.zulipchat.com#narrow/stream/266220-rustdoc/topic/warning%20sections%20in%20rustdoc%3A%20%2379677/near/218895728" class="zl"><img src="https://rust-lang.github.io/zulip_archive/assets/img/zulip.svg" alt="view this post on Zulip" style="width:20px;height:20px;"></a> GuillaumeGomez <a href="https://rust-lang.github.io/zulip_archive/stream/266220-rustdoc/topic/warning.20sections.20in.20rustdoc.3A.20.2379677.html#218895728">(Dec 04 2020 at 21:51)</a>:</h4>
<p>but it's not up to us to care about what others do with the JSON</p>



<a name="218895755"></a>
<h4><a href="https://rust-lang.zulipchat.com#narrow/stream/266220-rustdoc/topic/warning%20sections%20in%20rustdoc%3A%20%2379677/near/218895755" class="zl"><img src="https://rust-lang.github.io/zulip_archive/assets/img/zulip.svg" alt="view this post on Zulip" style="width:20px;height:20px;"></a> Joshua Nelson <a href="https://rust-lang.github.io/zulip_archive/stream/266220-rustdoc/topic/warning.20sections.20in.20rustdoc.3A.20.2379677.html#218895755">(Dec 04 2020 at 21:51)</a>:</h4>
<p>that really makes the JSON a second-class citizen :/</p>



<a name="218895766"></a>
<h4><a href="https://rust-lang.zulipchat.com#narrow/stream/266220-rustdoc/topic/warning%20sections%20in%20rustdoc%3A%20%2379677/near/218895766" class="zl"><img src="https://rust-lang.github.io/zulip_archive/assets/img/zulip.svg" alt="view this post on Zulip" style="width:20px;height:20px;"></a> Joshua Nelson <a href="https://rust-lang.github.io/zulip_archive/stream/266220-rustdoc/topic/warning.20sections.20in.20rustdoc.3A.20.2379677.html#218895766">(Dec 04 2020 at 21:51)</a>:</h4>
<p>we're not making all the information available to it</p>



<a name="218895777"></a>
<h4><a href="https://rust-lang.zulipchat.com#narrow/stream/266220-rustdoc/topic/warning%20sections%20in%20rustdoc%3A%20%2379677/near/218895777" class="zl"><img src="https://rust-lang.github.io/zulip_archive/assets/img/zulip.svg" alt="view this post on Zulip" style="width:20px;height:20px;"></a> GuillaumeGomez <a href="https://rust-lang.github.io/zulip_archive/stream/266220-rustdoc/topic/warning.20sections.20in.20rustdoc.3A.20.2379677.html#218895777">(Dec 04 2020 at 21:52)</a>:</h4>
<p>of course you, you can put html in doc comments because markdown allows it, so as long as the class exists in the CSS, what prevents you to not use it?</p>



<a name="218895824"></a>
<h4><a href="https://rust-lang.zulipchat.com#narrow/stream/266220-rustdoc/topic/warning%20sections%20in%20rustdoc%3A%20%2379677/near/218895824" class="zl"><img src="https://rust-lang.github.io/zulip_archive/assets/img/zulip.svg" alt="view this post on Zulip" style="width:20px;height:20px;"></a> Joshua Nelson <a href="https://rust-lang.github.io/zulip_archive/stream/266220-rustdoc/topic/warning.20sections.20in.20rustdoc.3A.20.2379677.html#218895824">(Dec 04 2020 at 21:52)</a>:</h4>
<p>oh I see what you mean</p>



<a name="218895828"></a>
<h4><a href="https://rust-lang.zulipchat.com#narrow/stream/266220-rustdoc/topic/warning%20sections%20in%20rustdoc%3A%20%2379677/near/218895828" class="zl"><img src="https://rust-lang.github.io/zulip_archive/assets/img/zulip.svg" alt="view this post on Zulip" style="width:20px;height:20px;"></a> Joshua Nelson <a href="https://rust-lang.github.io/zulip_archive/stream/266220-rustdoc/topic/warning.20sections.20in.20rustdoc.3A.20.2379677.html#218895828">(Dec 04 2020 at 21:52)</a>:</h4>
<p>the difference is that isn't stabilized</p>



<a name="218895845"></a>
<h4><a href="https://rust-lang.zulipchat.com#narrow/stream/266220-rustdoc/topic/warning%20sections%20in%20rustdoc%3A%20%2379677/near/218895845" class="zl"><img src="https://rust-lang.github.io/zulip_archive/assets/img/zulip.svg" alt="view this post on Zulip" style="width:20px;height:20px;"></a> Joshua Nelson <a href="https://rust-lang.github.io/zulip_archive/stream/266220-rustdoc/topic/warning.20sections.20in.20rustdoc.3A.20.2379677.html#218895845">(Dec 04 2020 at 21:52)</a>:</h4>
<p>it's just an artifact of how rustdoc is implemented</p>



<a name="218895848"></a>
<h4><a href="https://rust-lang.zulipchat.com#narrow/stream/266220-rustdoc/topic/warning%20sections%20in%20rustdoc%3A%20%2379677/near/218895848" class="zl"><img src="https://rust-lang.github.io/zulip_archive/assets/img/zulip.svg" alt="view this post on Zulip" style="width:20px;height:20px;"></a> GuillaumeGomez <a href="https://rust-lang.github.io/zulip_archive/stream/266220-rustdoc/topic/warning.20sections.20in.20rustdoc.3A.20.2379677.html#218895848">(Dec 04 2020 at 21:52)</a>:</h4>
<p>what do you mean?</p>



<a name="218895870"></a>
<h4><a href="https://rust-lang.zulipchat.com#narrow/stream/266220-rustdoc/topic/warning%20sections%20in%20rustdoc%3A%20%2379677/near/218895870" class="zl"><img src="https://rust-lang.github.io/zulip_archive/assets/img/zulip.svg" alt="view this post on Zulip" style="width:20px;height:20px;"></a> Joshua Nelson <a href="https://rust-lang.github.io/zulip_archive/stream/266220-rustdoc/topic/warning.20sections.20in.20rustdoc.3A.20.2379677.html#218895870">(Dec 04 2020 at 21:52)</a>:</h4>
<p>we could change the CSS classes without considering it a breaking change</p>



<a name="218895904"></a>
<h4><a href="https://rust-lang.zulipchat.com#narrow/stream/266220-rustdoc/topic/warning%20sections%20in%20rustdoc%3A%20%2379677/near/218895904" class="zl"><img src="https://rust-lang.github.io/zulip_archive/assets/img/zulip.svg" alt="view this post on Zulip" style="width:20px;height:20px;"></a> Joshua Nelson <a href="https://rust-lang.github.io/zulip_archive/stream/266220-rustdoc/topic/warning.20sections.20in.20rustdoc.3A.20.2379677.html#218895904">(Dec 04 2020 at 21:52)</a>:</h4>
<p>(or at least, I would be strongly opposed to considering that breaking change)</p>



<a name="218895961"></a>
<h4><a href="https://rust-lang.zulipchat.com#narrow/stream/266220-rustdoc/topic/warning%20sections%20in%20rustdoc%3A%20%2379677/near/218895961" class="zl"><img src="https://rust-lang.github.io/zulip_archive/assets/img/zulip.svg" alt="view this post on Zulip" style="width:20px;height:20px;"></a> Joshua Nelson <a href="https://rust-lang.github.io/zulip_archive/stream/266220-rustdoc/topic/warning.20sections.20in.20rustdoc.3A.20.2379677.html#218895961">(Dec 04 2020 at 21:53)</a>:</h4>
<p>basically my fear is that we're locking ourselves in to a specific implementation</p>



<a name="218896073"></a>
<h4><a href="https://rust-lang.zulipchat.com#narrow/stream/266220-rustdoc/topic/warning%20sections%20in%20rustdoc%3A%20%2379677/near/218896073" class="zl"><img src="https://rust-lang.github.io/zulip_archive/assets/img/zulip.svg" alt="view this post on Zulip" style="width:20px;height:20px;"></a> GuillaumeGomez <a href="https://rust-lang.github.io/zulip_archive/stream/266220-rustdoc/topic/warning.20sections.20in.20rustdoc.3A.20.2379677.html#218896073">(Dec 04 2020 at 21:54)</a>:</h4>
<p>well, we have to in a way</p>



<a name="218896099"></a>
<h4><a href="https://rust-lang.zulipchat.com#narrow/stream/266220-rustdoc/topic/warning%20sections%20in%20rustdoc%3A%20%2379677/near/218896099" class="zl"><img src="https://rust-lang.github.io/zulip_archive/assets/img/zulip.svg" alt="view this post on Zulip" style="width:20px;height:20px;"></a> GuillaumeGomez <a href="https://rust-lang.github.io/zulip_archive/stream/266220-rustdoc/topic/warning.20sections.20in.20rustdoc.3A.20.2379677.html#218896099">(Dec 04 2020 at 21:55)</a>:</h4>
<p>otherwise, we'd break <a href="http://docs.rs">docs.rs</a> too</p>



<a name="218896117"></a>
<h4><a href="https://rust-lang.zulipchat.com#narrow/stream/266220-rustdoc/topic/warning%20sections%20in%20rustdoc%3A%20%2379677/near/218896117" class="zl"><img src="https://rust-lang.github.io/zulip_archive/assets/img/zulip.svg" alt="view this post on Zulip" style="width:20px;height:20px;"></a> GuillaumeGomez <a href="https://rust-lang.github.io/zulip_archive/stream/266220-rustdoc/topic/warning.20sections.20in.20rustdoc.3A.20.2379677.html#218896117">(Dec 04 2020 at 21:55)</a>:</h4>
<p>UI changes can only be small and one at a time</p>



<a name="218896132"></a>
<h4><a href="https://rust-lang.zulipchat.com#narrow/stream/266220-rustdoc/topic/warning%20sections%20in%20rustdoc%3A%20%2379677/near/218896132" class="zl"><img src="https://rust-lang.github.io/zulip_archive/assets/img/zulip.svg" alt="view this post on Zulip" style="width:20px;height:20px;"></a> Joshua Nelson <a href="https://rust-lang.github.io/zulip_archive/stream/266220-rustdoc/topic/warning.20sections.20in.20rustdoc.3A.20.2379677.html#218896132">(Dec 04 2020 at 21:55)</a>:</h4>
<p>I don't see how this is related to <a href="http://docs.rs">docs.rs</a></p>



<a name="218896148"></a>
<h4><a href="https://rust-lang.zulipchat.com#narrow/stream/266220-rustdoc/topic/warning%20sections%20in%20rustdoc%3A%20%2379677/near/218896148" class="zl"><img src="https://rust-lang.github.io/zulip_archive/assets/img/zulip.svg" alt="view this post on Zulip" style="width:20px;height:20px;"></a> Joshua Nelson <a href="https://rust-lang.github.io/zulip_archive/stream/266220-rustdoc/topic/warning.20sections.20in.20rustdoc.3A.20.2379677.html#218896148">(Dec 04 2020 at 21:55)</a>:</h4>
<p><a href="http://docs.rs">docs.rs</a> isn't adding any documentation with <code>class="rustdoc-warning"</code></p>



<a name="218896178"></a>
<h4><a href="https://rust-lang.zulipchat.com#narrow/stream/266220-rustdoc/topic/warning%20sections%20in%20rustdoc%3A%20%2379677/near/218896178" class="zl"><img src="https://rust-lang.github.io/zulip_archive/assets/img/zulip.svg" alt="view this post on Zulip" style="width:20px;height:20px;"></a> Joshua Nelson <a href="https://rust-lang.github.io/zulip_archive/stream/266220-rustdoc/topic/warning.20sections.20in.20rustdoc.3A.20.2379677.html#218896178">(Dec 04 2020 at 21:55)</a>:</h4>
<p>and I wouldn't consider it to need the same stability guarentees as library authors</p>



<a name="218896265"></a>
<h4><a href="https://rust-lang.zulipchat.com#narrow/stream/266220-rustdoc/topic/warning%20sections%20in%20rustdoc%3A%20%2379677/near/218896265" class="zl"><img src="https://rust-lang.github.io/zulip_archive/assets/img/zulip.svg" alt="view this post on Zulip" style="width:20px;height:20px;"></a> GuillaumeGomez <a href="https://rust-lang.github.io/zulip_archive/stream/266220-rustdoc/topic/warning.20sections.20in.20rustdoc.3A.20.2379677.html#218896265">(Dec 04 2020 at 21:56)</a>:</h4>
<p>yep, but it's officially documented as an "add"</p>



<a name="218896340"></a>
<h4><a href="https://rust-lang.zulipchat.com#narrow/stream/266220-rustdoc/topic/warning%20sections%20in%20rustdoc%3A%20%2379677/near/218896340" class="zl"><img src="https://rust-lang.github.io/zulip_archive/assets/img/zulip.svg" alt="view this post on Zulip" style="width:20px;height:20px;"></a> Joshua Nelson <a href="https://rust-lang.github.io/zulip_archive/stream/266220-rustdoc/topic/warning.20sections.20in.20rustdoc.3A.20.2379677.html#218896340">(Dec 04 2020 at 21:57)</a>:</h4>
<p>I don't follow</p>



<a name="218896355"></a>
<h4><a href="https://rust-lang.zulipchat.com#narrow/stream/266220-rustdoc/topic/warning%20sections%20in%20rustdoc%3A%20%2379677/near/218896355" class="zl"><img src="https://rust-lang.github.io/zulip_archive/assets/img/zulip.svg" alt="view this post on Zulip" style="width:20px;height:20px;"></a> GuillaumeGomez <a href="https://rust-lang.github.io/zulip_archive/stream/266220-rustdoc/topic/warning.20sections.20in.20rustdoc.3A.20.2379677.html#218896355">(Dec 04 2020 at 21:57)</a>:</h4>
<p>friday evening makes me bad with talks, sorry XD</p>



<a name="218896366"></a>
<h4><a href="https://rust-lang.zulipchat.com#narrow/stream/266220-rustdoc/topic/warning%20sections%20in%20rustdoc%3A%20%2379677/near/218896366" class="zl"><img src="https://rust-lang.github.io/zulip_archive/assets/img/zulip.svg" alt="view this post on Zulip" style="width:20px;height:20px;"></a> Joshua Nelson <a href="https://rust-lang.github.io/zulip_archive/stream/266220-rustdoc/topic/warning.20sections.20in.20rustdoc.3A.20.2379677.html#218896366">(Dec 04 2020 at 21:57)</a>:</h4>
<p>we can wait until next week if you like <span aria-label="smile" class="emoji emoji-1f642" role="img" title="smile">:smile:</span></p>



<a name="218896379"></a>
<h4><a href="https://rust-lang.zulipchat.com#narrow/stream/266220-rustdoc/topic/warning%20sections%20in%20rustdoc%3A%20%2379677/near/218896379" class="zl"><img src="https://rust-lang.github.io/zulip_archive/assets/img/zulip.svg" alt="view this post on Zulip" style="width:20px;height:20px;"></a> GuillaumeGomez <a href="https://rust-lang.github.io/zulip_archive/stream/266220-rustdoc/topic/warning.20sections.20in.20rustdoc.3A.20.2379677.html#218896379">(Dec 04 2020 at 21:57)</a>:</h4>
<p>so, in any case, in your JSON you'll have the rustdoc-warning tag</p>



<a name="218896429"></a>
<h4><a href="https://rust-lang.zulipchat.com#narrow/stream/266220-rustdoc/topic/warning%20sections%20in%20rustdoc%3A%20%2379677/near/218896429" class="zl"><img src="https://rust-lang.github.io/zulip_archive/assets/img/zulip.svg" alt="view this post on Zulip" style="width:20px;height:20px;"></a> GuillaumeGomez <a href="https://rust-lang.github.io/zulip_archive/stream/266220-rustdoc/topic/warning.20sections.20in.20rustdoc.3A.20.2379677.html#218896429">(Dec 04 2020 at 21:58)</a>:</h4>
<p>we can assume they'll have a markdown parser</p>



<a name="218896448"></a>
<h4><a href="https://rust-lang.zulipchat.com#narrow/stream/266220-rustdoc/topic/warning%20sections%20in%20rustdoc%3A%20%2379677/near/218896448" class="zl"><img src="https://rust-lang.github.io/zulip_archive/assets/img/zulip.svg" alt="view this post on Zulip" style="width:20px;height:20px;"></a> GuillaumeGomez <a href="https://rust-lang.github.io/zulip_archive/stream/266220-rustdoc/topic/warning.20sections.20in.20rustdoc.3A.20.2379677.html#218896448">(Dec 04 2020 at 21:58)</a>:</h4>
<p>since the <code>rustdoc-warning</code> class is documented, they can handle it</p>



<a name="218896454"></a>
<h4><a href="https://rust-lang.zulipchat.com#narrow/stream/266220-rustdoc/topic/warning%20sections%20in%20rustdoc%3A%20%2379677/near/218896454" class="zl"><img src="https://rust-lang.github.io/zulip_archive/assets/img/zulip.svg" alt="view this post on Zulip" style="width:20px;height:20px;"></a> Joshua Nelson <a href="https://rust-lang.github.io/zulip_archive/stream/266220-rustdoc/topic/warning.20sections.20in.20rustdoc.3A.20.2379677.html#218896454">(Dec 04 2020 at 21:58)</a>:</h4>
<p>well now they need to have an HTML parser too :/</p>



<a name="218896462"></a>
<h4><a href="https://rust-lang.zulipchat.com#narrow/stream/266220-rustdoc/topic/warning%20sections%20in%20rustdoc%3A%20%2379677/near/218896462" class="zl"><img src="https://rust-lang.github.io/zulip_archive/assets/img/zulip.svg" alt="view this post on Zulip" style="width:20px;height:20px;"></a> Joshua Nelson <a href="https://rust-lang.github.io/zulip_archive/stream/266220-rustdoc/topic/warning.20sections.20in.20rustdoc.3A.20.2379677.html#218896462">(Dec 04 2020 at 21:58)</a>:</h4>
<p>the two are not the same, pulldown does not handle HTML</p>



<a name="218896470"></a>
<h4><a href="https://rust-lang.zulipchat.com#narrow/stream/266220-rustdoc/topic/warning%20sections%20in%20rustdoc%3A%20%2379677/near/218896470" class="zl"><img src="https://rust-lang.github.io/zulip_archive/assets/img/zulip.svg" alt="view this post on Zulip" style="width:20px;height:20px;"></a> GuillaumeGomez <a href="https://rust-lang.github.io/zulip_archive/stream/266220-rustdoc/topic/warning.20sections.20in.20rustdoc.3A.20.2379677.html#218896470">(Dec 04 2020 at 21:58)</a>:</h4>
<p>so my question is: why would you want to change this class? The display is not related to the JSON</p>



<a name="218896481"></a>
<h4><a href="https://rust-lang.zulipchat.com#narrow/stream/266220-rustdoc/topic/warning%20sections%20in%20rustdoc%3A%20%2379677/near/218896481" class="zl"><img src="https://rust-lang.github.io/zulip_archive/assets/img/zulip.svg" alt="view this post on Zulip" style="width:20px;height:20px;"></a> GuillaumeGomez <a href="https://rust-lang.github.io/zulip_archive/stream/266220-rustdoc/topic/warning.20sections.20in.20rustdoc.3A.20.2379677.html#218896481">(Dec 04 2020 at 21:58)</a>:</h4>
<p>pulldown handles HTML</p>



<a name="218896492"></a>
<h4><a href="https://rust-lang.zulipchat.com#narrow/stream/266220-rustdoc/topic/warning%20sections%20in%20rustdoc%3A%20%2379677/near/218896492" class="zl"><img src="https://rust-lang.github.io/zulip_archive/assets/img/zulip.svg" alt="view this post on Zulip" style="width:20px;height:20px;"></a> Joshua Nelson <a href="https://rust-lang.github.io/zulip_archive/stream/266220-rustdoc/topic/warning.20sections.20in.20rustdoc.3A.20.2379677.html#218896492">(Dec 04 2020 at 21:58)</a>:</h4>
<p>pulldown does not <em>parse</em> HTML</p>



<a name="218896497"></a>
<h4><a href="https://rust-lang.zulipchat.com#narrow/stream/266220-rustdoc/topic/warning%20sections%20in%20rustdoc%3A%20%2379677/near/218896497" class="zl"><img src="https://rust-lang.github.io/zulip_archive/assets/img/zulip.svg" alt="view this post on Zulip" style="width:20px;height:20px;"></a> GuillaumeGomez <a href="https://rust-lang.github.io/zulip_archive/stream/266220-rustdoc/topic/warning.20sections.20in.20rustdoc.3A.20.2379677.html#218896497">(Dec 04 2020 at 21:59)</a>:</h4>
<p>it doesn't display it, which is totally different</p>



<a name="218896507"></a>
<h4><a href="https://rust-lang.zulipchat.com#narrow/stream/266220-rustdoc/topic/warning%20sections%20in%20rustdoc%3A%20%2379677/near/218896507" class="zl"><img src="https://rust-lang.github.io/zulip_archive/assets/img/zulip.svg" alt="view this post on Zulip" style="width:20px;height:20px;"></a> GuillaumeGomez <a href="https://rust-lang.github.io/zulip_archive/stream/266220-rustdoc/topic/warning.20sections.20in.20rustdoc.3A.20.2379677.html#218896507">(Dec 04 2020 at 21:59)</a>:</h4>
<p>html is part of markdown spec</p>



<a name="218896515"></a>
<h4><a href="https://rust-lang.zulipchat.com#narrow/stream/266220-rustdoc/topic/warning%20sections%20in%20rustdoc%3A%20%2379677/near/218896515" class="zl"><img src="https://rust-lang.github.io/zulip_archive/assets/img/zulip.svg" alt="view this post on Zulip" style="width:20px;height:20px;"></a> Joshua Nelson <a href="https://rust-lang.github.io/zulip_archive/stream/266220-rustdoc/topic/warning.20sections.20in.20rustdoc.3A.20.2379677.html#218896515">(Dec 04 2020 at 21:59)</a>:</h4>
<p><a href="https://github.com/raphlinus/pulldown-cmark/issues/484#issuecomment-698964416">https://github.com/raphlinus/pulldown-cmark/issues/484#issuecomment-698964416</a></p>



<a name="218896661"></a>
<h4><a href="https://rust-lang.zulipchat.com#narrow/stream/266220-rustdoc/topic/warning%20sections%20in%20rustdoc%3A%20%2379677/near/218896661" class="zl"><img src="https://rust-lang.github.io/zulip_archive/assets/img/zulip.svg" alt="view this post on Zulip" style="width:20px;height:20px;"></a> GuillaumeGomez <a href="https://rust-lang.github.io/zulip_archive/stream/266220-rustdoc/topic/warning.20sections.20in.20rustdoc.3A.20.2379677.html#218896661">(Dec 04 2020 at 22:00)</a>:</h4>
<p>Ah no, it's different</p>



<a name="218896688"></a>
<h4><a href="https://rust-lang.zulipchat.com#narrow/stream/266220-rustdoc/topic/warning%20sections%20in%20rustdoc%3A%20%2379677/near/218896688" class="zl"><img src="https://rust-lang.github.io/zulip_archive/assets/img/zulip.svg" alt="view this post on Zulip" style="width:20px;height:20px;"></a> GuillaumeGomez <a href="https://rust-lang.github.io/zulip_archive/stream/266220-rustdoc/topic/warning.20sections.20in.20rustdoc.3A.20.2379677.html#218896688">(Dec 04 2020 at 22:00)</a>:</h4>
<p>pulldown just say "I saw something which looks like an HTML tag and marked it as such"</p>



<a name="218896692"></a>
<h4><a href="https://rust-lang.zulipchat.com#narrow/stream/266220-rustdoc/topic/warning%20sections%20in%20rustdoc%3A%20%2379677/near/218896692" class="zl"><img src="https://rust-lang.github.io/zulip_archive/assets/img/zulip.svg" alt="view this post on Zulip" style="width:20px;height:20px;"></a> GuillaumeGomez <a href="https://rust-lang.github.io/zulip_archive/stream/266220-rustdoc/topic/warning.20sections.20in.20rustdoc.3A.20.2379677.html#218896692">(Dec 04 2020 at 22:00)</a>:</h4>
<p>but that's it</p>



<a name="218896701"></a>
<h4><a href="https://rust-lang.zulipchat.com#narrow/stream/266220-rustdoc/topic/warning%20sections%20in%20rustdoc%3A%20%2379677/near/218896701" class="zl"><img src="https://rust-lang.github.io/zulip_archive/assets/img/zulip.svg" alt="view this post on Zulip" style="width:20px;height:20px;"></a> GuillaumeGomez <a href="https://rust-lang.github.io/zulip_archive/stream/266220-rustdoc/topic/warning.20sections.20in.20rustdoc.3A.20.2379677.html#218896701">(Dec 04 2020 at 22:01)</a>:</h4>
<p>it's not parsing the HTML so to speak</p>



<a name="218896709"></a>
<h4><a href="https://rust-lang.zulipchat.com#narrow/stream/266220-rustdoc/topic/warning%20sections%20in%20rustdoc%3A%20%2379677/near/218896709" class="zl"><img src="https://rust-lang.github.io/zulip_archive/assets/img/zulip.svg" alt="view this post on Zulip" style="width:20px;height:20px;"></a> Joshua Nelson <a href="https://rust-lang.github.io/zulip_archive/stream/266220-rustdoc/topic/warning.20sections.20in.20rustdoc.3A.20.2379677.html#218896709">(Dec 04 2020 at 22:01)</a>:</h4>
<p>right, that's what I mean</p>



<a name="218896819"></a>
<h4><a href="https://rust-lang.zulipchat.com#narrow/stream/266220-rustdoc/topic/warning%20sections%20in%20rustdoc%3A%20%2379677/near/218896819" class="zl"><img src="https://rust-lang.github.io/zulip_archive/assets/img/zulip.svg" alt="view this post on Zulip" style="width:20px;height:20px;"></a> GuillaumeGomez <a href="https://rust-lang.github.io/zulip_archive/stream/266220-rustdoc/topic/warning.20sections.20in.20rustdoc.3A.20.2379677.html#218896819">(Dec 04 2020 at 22:02)</a>:</h4>
<p>we can already add html in markdown, JSON output already has to deal with it</p>



<a name="218896856"></a>
<h4><a href="https://rust-lang.zulipchat.com#narrow/stream/266220-rustdoc/topic/warning%20sections%20in%20rustdoc%3A%20%2379677/near/218896856" class="zl"><img src="https://rust-lang.github.io/zulip_archive/assets/img/zulip.svg" alt="view this post on Zulip" style="width:20px;height:20px;"></a> Joshua Nelson <a href="https://rust-lang.github.io/zulip_archive/stream/266220-rustdoc/topic/warning.20sections.20in.20rustdoc.3A.20.2379677.html#218896856">(Dec 04 2020 at 22:02)</a>:</h4>
<p>well, I guess this is more of a principle of the thing, but right now the HTML is just an implementation detail</p>



<a name="218896875"></a>
<h4><a href="https://rust-lang.zulipchat.com#narrow/stream/266220-rustdoc/topic/warning%20sections%20in%20rustdoc%3A%20%2379677/near/218896875" class="zl"><img src="https://rust-lang.github.io/zulip_archive/assets/img/zulip.svg" alt="view this post on Zulip" style="width:20px;height:20px;"></a> Joshua Nelson <a href="https://rust-lang.github.io/zulip_archive/stream/266220-rustdoc/topic/warning.20sections.20in.20rustdoc.3A.20.2379677.html#218896875">(Dec 04 2020 at 22:02)</a>:</h4>
<p>we don't <em>recommend</em> that you use HTML</p>



<a name="218897092"></a>
<h4><a href="https://rust-lang.zulipchat.com#narrow/stream/266220-rustdoc/topic/warning%20sections%20in%20rustdoc%3A%20%2379677/near/218897092" class="zl"><img src="https://rust-lang.github.io/zulip_archive/assets/img/zulip.svg" alt="view this post on Zulip" style="width:20px;height:20px;"></a> GuillaumeGomez <a href="https://rust-lang.github.io/zulip_archive/stream/266220-rustdoc/topic/warning.20sections.20in.20rustdoc.3A.20.2379677.html#218897092">(Dec 04 2020 at 22:04)</a>:</h4>
<p>Euuuuh... Well, we definitely recommend it XD</p>



<a name="218897098"></a>
<h4><a href="https://rust-lang.zulipchat.com#narrow/stream/266220-rustdoc/topic/warning%20sections%20in%20rustdoc%3A%20%2379677/near/218897098" class="zl"><img src="https://rust-lang.github.io/zulip_archive/assets/img/zulip.svg" alt="view this post on Zulip" style="width:20px;height:20px;"></a> GuillaumeGomez <a href="https://rust-lang.github.io/zulip_archive/stream/266220-rustdoc/topic/warning.20sections.20in.20rustdoc.3A.20.2379677.html#218897098">(Dec 04 2020 at 22:05)</a>:</h4>
<p>well, no</p>



<a name="218897107"></a>
<h4><a href="https://rust-lang.zulipchat.com#narrow/stream/266220-rustdoc/topic/warning%20sections%20in%20rustdoc%3A%20%2379677/near/218897107" class="zl"><img src="https://rust-lang.github.io/zulip_archive/assets/img/zulip.svg" alt="view this post on Zulip" style="width:20px;height:20px;"></a> GuillaumeGomez <a href="https://rust-lang.github.io/zulip_archive/stream/266220-rustdoc/topic/warning.20sections.20in.20rustdoc.3A.20.2379677.html#218897107">(Dec 04 2020 at 22:05)</a>:</h4>
<p>badly phrased it</p>



<a name="218897139"></a>
<h4><a href="https://rust-lang.zulipchat.com#narrow/stream/266220-rustdoc/topic/warning%20sections%20in%20rustdoc%3A%20%2379677/near/218897139" class="zl"><img src="https://rust-lang.github.io/zulip_archive/assets/img/zulip.svg" alt="view this post on Zulip" style="width:20px;height:20px;"></a> GuillaumeGomez <a href="https://rust-lang.github.io/zulip_archive/stream/266220-rustdoc/topic/warning.20sections.20in.20rustdoc.3A.20.2379677.html#218897139">(Dec 04 2020 at 22:05)</a>:</h4>
<p>we don't say anything about it, except that it's supported and working</p>



<a name="218897149"></a>
<h4><a href="https://rust-lang.zulipchat.com#narrow/stream/266220-rustdoc/topic/warning%20sections%20in%20rustdoc%3A%20%2379677/near/218897149" class="zl"><img src="https://rust-lang.github.io/zulip_archive/assets/img/zulip.svg" alt="view this post on Zulip" style="width:20px;height:20px;"></a> Joshua Nelson <a href="https://rust-lang.github.io/zulip_archive/stream/266220-rustdoc/topic/warning.20sections.20in.20rustdoc.3A.20.2379677.html#218897149">(Dec 04 2020 at 22:05)</a>:</h4>
<p>right exactly</p>



<a name="218897154"></a>
<h4><a href="https://rust-lang.zulipchat.com#narrow/stream/266220-rustdoc/topic/warning%20sections%20in%20rustdoc%3A%20%2379677/near/218897154" class="zl"><img src="https://rust-lang.github.io/zulip_archive/assets/img/zulip.svg" alt="view this post on Zulip" style="width:20px;height:20px;"></a> Joshua Nelson <a href="https://rust-lang.github.io/zulip_archive/stream/266220-rustdoc/topic/warning.20sections.20in.20rustdoc.3A.20.2379677.html#218897154">(Dec 04 2020 at 22:05)</a>:</h4>
<p>it's an implementation detail</p>



<a name="218897234"></a>
<h4><a href="https://rust-lang.zulipchat.com#narrow/stream/266220-rustdoc/topic/warning%20sections%20in%20rustdoc%3A%20%2379677/near/218897234" class="zl"><img src="https://rust-lang.github.io/zulip_archive/assets/img/zulip.svg" alt="view this post on Zulip" style="width:20px;height:20px;"></a> GuillaumeGomez <a href="https://rust-lang.github.io/zulip_archive/stream/266220-rustdoc/topic/warning.20sections.20in.20rustdoc.3A.20.2379677.html#218897234">(Dec 04 2020 at 22:06)</a>:</h4>
<p>not really, it's a whole part of markdown</p>



<a name="218897264"></a>
<h4><a href="https://rust-lang.zulipchat.com#narrow/stream/266220-rustdoc/topic/warning%20sections%20in%20rustdoc%3A%20%2379677/near/218897264" class="zl"><img src="https://rust-lang.github.io/zulip_archive/assets/img/zulip.svg" alt="view this post on Zulip" style="width:20px;height:20px;"></a> GuillaumeGomez <a href="https://rust-lang.github.io/zulip_archive/stream/266220-rustdoc/topic/warning.20sections.20in.20rustdoc.3A.20.2379677.html#218897264">(Dec 04 2020 at 22:06)</a>:</h4>
<p>and in this case, we need to have this HTML element before we can add the syntax extension (because in the end, the extension will generate this HTML)</p>



<a name="218897284"></a>
<h4><a href="https://rust-lang.zulipchat.com#narrow/stream/266220-rustdoc/topic/warning%20sections%20in%20rustdoc%3A%20%2379677/near/218897284" class="zl"><img src="https://rust-lang.github.io/zulip_archive/assets/img/zulip.svg" alt="view this post on Zulip" style="width:20px;height:20px;"></a> GuillaumeGomez <a href="https://rust-lang.github.io/zulip_archive/stream/266220-rustdoc/topic/warning.20sections.20in.20rustdoc.3A.20.2379677.html#218897284">(Dec 04 2020 at 22:06)</a>:</h4>
<p>but yes, in the end, the markdown will look better with an extension</p>



<a name="218897298"></a>
<h4><a href="https://rust-lang.zulipchat.com#narrow/stream/266220-rustdoc/topic/warning%20sections%20in%20rustdoc%3A%20%2379677/near/218897298" class="zl"><img src="https://rust-lang.github.io/zulip_archive/assets/img/zulip.svg" alt="view this post on Zulip" style="width:20px;height:20px;"></a> Joshua Nelson <a href="https://rust-lang.github.io/zulip_archive/stream/266220-rustdoc/topic/warning.20sections.20in.20rustdoc.3A.20.2379677.html#218897298">(Dec 04 2020 at 22:07)</a>:</h4>
<p><span class="user-mention silent" data-user-id="210316">GuillaumeGomez</span> <a href="#narrow/stream/266220-rustdoc/topic/warning.20sections.20in.20rustdoc.3A.20.2379677/near/218897264">said</a>:</p>
<blockquote>
<p>and in this case, we need to have this HTML element before we can add the syntax extension (because in the end, the extension will generate this HTML)</p>
</blockquote>
<p>I understand that, you keep saying it, but it's not at all related to <em>stabilizing</em> the HTML element</p>



<a name="218897312"></a>
<h4><a href="https://rust-lang.zulipchat.com#narrow/stream/266220-rustdoc/topic/warning%20sections%20in%20rustdoc%3A%20%2379677/near/218897312" class="zl"><img src="https://rust-lang.github.io/zulip_archive/assets/img/zulip.svg" alt="view this post on Zulip" style="width:20px;height:20px;"></a> Joshua Nelson <a href="https://rust-lang.github.io/zulip_archive/stream/266220-rustdoc/topic/warning.20sections.20in.20rustdoc.3A.20.2379677.html#218897312">(Dec 04 2020 at 22:07)</a>:</h4>
<p>which is the bit I'm concerned about</p>



<a name="218897313"></a>
<h4><a href="https://rust-lang.zulipchat.com#narrow/stream/266220-rustdoc/topic/warning%20sections%20in%20rustdoc%3A%20%2379677/near/218897313" class="zl"><img src="https://rust-lang.github.io/zulip_archive/assets/img/zulip.svg" alt="view this post on Zulip" style="width:20px;height:20px;"></a> GuillaumeGomez <a href="https://rust-lang.github.io/zulip_archive/stream/266220-rustdoc/topic/warning.20sections.20in.20rustdoc.3A.20.2379677.html#218897313">(Dec 04 2020 at 22:07)</a>:</h4>
<p>however, please keep in mind that using a rustdoc-specific extension will also have a cost for people using the JSON output</p>



<a name="218897392"></a>
<h4><a href="https://rust-lang.zulipchat.com#narrow/stream/266220-rustdoc/topic/warning%20sections%20in%20rustdoc%3A%20%2379677/near/218897392" class="zl"><img src="https://rust-lang.github.io/zulip_archive/assets/img/zulip.svg" alt="view this post on Zulip" style="width:20px;height:20px;"></a> Joshua Nelson <a href="https://rust-lang.github.io/zulip_archive/stream/266220-rustdoc/topic/warning.20sections.20in.20rustdoc.3A.20.2379677.html#218897392">(Dec 04 2020 at 22:08)</a>:</h4>
<p>right, yes, you have to parse the extension</p>



<a name="218897442"></a>
<h4><a href="https://rust-lang.zulipchat.com#narrow/stream/266220-rustdoc/topic/warning%20sections%20in%20rustdoc%3A%20%2379677/near/218897442" class="zl"><img src="https://rust-lang.github.io/zulip_archive/assets/img/zulip.svg" alt="view this post on Zulip" style="width:20px;height:20px;"></a> Joshua Nelson <a href="https://rust-lang.github.io/zulip_archive/stream/266220-rustdoc/topic/warning.20sections.20in.20rustdoc.3A.20.2379677.html#218897442">(Dec 04 2020 at 22:08)</a>:</h4>
<p>but it's possible rustdoc could expose it in the JSON at some point</p>



<a name="218897443"></a>
<h4><a href="https://rust-lang.zulipchat.com#narrow/stream/266220-rustdoc/topic/warning%20sections%20in%20rustdoc%3A%20%2379677/near/218897443" class="zl"><img src="https://rust-lang.github.io/zulip_archive/assets/img/zulip.svg" alt="view this post on Zulip" style="width:20px;height:20px;"></a> GuillaumeGomez <a href="https://rust-lang.github.io/zulip_archive/stream/266220-rustdoc/topic/warning.20sections.20in.20rustdoc.3A.20.2379677.html#218897443">(Dec 04 2020 at 22:08)</a>:</h4>
<p>well, if the problem is that it's being put too much forward, I can remove the doc about it so that we'll only talk about it once we have the syntax extension. I'm fine with it too haha</p>



<a name="218897452"></a>
<h4><a href="https://rust-lang.zulipchat.com#narrow/stream/266220-rustdoc/topic/warning%20sections%20in%20rustdoc%3A%20%2379677/near/218897452" class="zl"><img src="https://rust-lang.github.io/zulip_archive/assets/img/zulip.svg" alt="view this post on Zulip" style="width:20px;height:20px;"></a> Joshua Nelson <a href="https://rust-lang.github.io/zulip_archive/stream/266220-rustdoc/topic/warning.20sections.20in.20rustdoc.3A.20.2379677.html#218897452">(Dec 04 2020 at 22:08)</a>:</h4>
<p>without having to add an HTML parser of its own</p>



<a name="218897474"></a>
<h4><a href="https://rust-lang.zulipchat.com#narrow/stream/266220-rustdoc/topic/warning%20sections%20in%20rustdoc%3A%20%2379677/near/218897474" class="zl"><img src="https://rust-lang.github.io/zulip_archive/assets/img/zulip.svg" alt="view this post on Zulip" style="width:20px;height:20px;"></a> Joshua Nelson <a href="https://rust-lang.github.io/zulip_archive/stream/266220-rustdoc/topic/warning.20sections.20in.20rustdoc.3A.20.2379677.html#218897474">(Dec 04 2020 at 22:08)</a>:</h4>
<p>ok great :)</p>



<a name="218897559"></a>
<h4><a href="https://rust-lang.zulipchat.com#narrow/stream/266220-rustdoc/topic/warning%20sections%20in%20rustdoc%3A%20%2379677/near/218897559" class="zl"><img src="https://rust-lang.github.io/zulip_archive/assets/img/zulip.svg" alt="view this post on Zulip" style="width:20px;height:20px;"></a> GuillaumeGomez <a href="https://rust-lang.github.io/zulip_archive/stream/266220-rustdoc/topic/warning.20sections.20in.20rustdoc.3A.20.2379677.html#218897559">(Dec 04 2020 at 22:09)</a>:</h4>
<p>then we don't need the fcp anymore I guess?</p>



<a name="218897820"></a>
<h4><a href="https://rust-lang.zulipchat.com#narrow/stream/266220-rustdoc/topic/warning%20sections%20in%20rustdoc%3A%20%2379677/near/218897820" class="zl"><img src="https://rust-lang.github.io/zulip_archive/assets/img/zulip.svg" alt="view this post on Zulip" style="width:20px;height:20px;"></a> GuillaumeGomez <a href="https://rust-lang.github.io/zulip_archive/stream/266220-rustdoc/topic/warning.20sections.20in.20rustdoc.3A.20.2379677.html#218897820">(Dec 04 2020 at 22:11)</a>:</h4>
<p>Still remain the big unknown: what will the syntax extension look like?</p>



<a name="218897836"></a>
<h4><a href="https://rust-lang.zulipchat.com#narrow/stream/266220-rustdoc/topic/warning%20sections%20in%20rustdoc%3A%20%2379677/near/218897836" class="zl"><img src="https://rust-lang.github.io/zulip_archive/assets/img/zulip.svg" alt="view this post on Zulip" style="width:20px;height:20px;"></a> GuillaumeGomez <a href="https://rust-lang.github.io/zulip_archive/stream/266220-rustdoc/topic/warning.20sections.20in.20rustdoc.3A.20.2379677.html#218897836">(Dec 04 2020 at 22:11)</a>:</h4>
<p>on that point, I really have no suggestion...</p>



<a name="218898328"></a>
<h4><a href="https://rust-lang.zulipchat.com#narrow/stream/266220-rustdoc/topic/warning%20sections%20in%20rustdoc%3A%20%2379677/near/218898328" class="zl"><img src="https://rust-lang.github.io/zulip_archive/assets/img/zulip.svg" alt="view this post on Zulip" style="width:20px;height:20px;"></a> Joshua Nelson <a href="https://rust-lang.github.io/zulip_archive/stream/266220-rustdoc/topic/warning.20sections.20in.20rustdoc.3A.20.2379677.html#218898328">(Dec 04 2020 at 22:16)</a>:</h4>
<p>I liked the <code>WARNING:</code> suggestion</p>



<a name="218898487"></a>
<h4><a href="https://rust-lang.zulipchat.com#narrow/stream/266220-rustdoc/topic/warning%20sections%20in%20rustdoc%3A%20%2379677/near/218898487" class="zl"><img src="https://rust-lang.github.io/zulip_archive/assets/img/zulip.svg" alt="view this post on Zulip" style="width:20px;height:20px;"></a> GuillaumeGomez <a href="https://rust-lang.github.io/zulip_archive/stream/266220-rustdoc/topic/warning.20sections.20in.20rustdoc.3A.20.2379677.html#218898487">(Dec 04 2020 at 22:18)</a>:</h4>
<p>I don't because it doesn't have a clear separation from the end of the text</p>



<a name="218898571"></a>
<h4><a href="https://rust-lang.zulipchat.com#narrow/stream/266220-rustdoc/topic/warning%20sections%20in%20rustdoc%3A%20%2379677/near/218898571" class="zl"><img src="https://rust-lang.github.io/zulip_archive/assets/img/zulip.svg" alt="view this post on Zulip" style="width:20px;height:20px;"></a> Joshua Nelson <a href="https://rust-lang.github.io/zulip_archive/stream/266220-rustdoc/topic/warning.20sections.20in.20rustdoc.3A.20.2379677.html#218898571">(Dec 04 2020 at 22:19)</a>:</h4>
<p>we could use a line break as the separation</p>



<a name="218898583"></a>
<h4><a href="https://rust-lang.zulipchat.com#narrow/stream/266220-rustdoc/topic/warning%20sections%20in%20rustdoc%3A%20%2379677/near/218898583" class="zl"><img src="https://rust-lang.github.io/zulip_archive/assets/img/zulip.svg" alt="view this post on Zulip" style="width:20px;height:20px;"></a> Joshua Nelson <a href="https://rust-lang.github.io/zulip_archive/stream/266220-rustdoc/topic/warning.20sections.20in.20rustdoc.3A.20.2379677.html#218898583">(Dec 04 2020 at 22:19)</a>:</h4>
<p>that's consistent with how it's normally used I think</p>



<a name="218898670"></a>
<h4><a href="https://rust-lang.zulipchat.com#narrow/stream/266220-rustdoc/topic/warning%20sections%20in%20rustdoc%3A%20%2379677/near/218898670" class="zl"><img src="https://rust-lang.github.io/zulip_archive/assets/img/zulip.svg" alt="view this post on Zulip" style="width:20px;height:20px;"></a> GuillaumeGomez <a href="https://rust-lang.github.io/zulip_archive/stream/266220-rustdoc/topic/warning.20sections.20in.20rustdoc.3A.20.2379677.html#218898670">(Dec 04 2020 at 22:20)</a>:</h4>
<p>I don't have a strong opinion on this to be honest. Whatever people mostly prefer, I'll implement it. My only condition is: it has to be fully markdown compliant</p>



<a name="218898687"></a>
<h4><a href="https://rust-lang.zulipchat.com#narrow/stream/266220-rustdoc/topic/warning%20sections%20in%20rustdoc%3A%20%2379677/near/218898687" class="zl"><img src="https://rust-lang.github.io/zulip_archive/assets/img/zulip.svg" alt="view this post on Zulip" style="width:20px;height:20px;"></a> GuillaumeGomez <a href="https://rust-lang.github.io/zulip_archive/stream/266220-rustdoc/topic/warning.20sections.20in.20rustdoc.3A.20.2379677.html#218898687">(Dec 04 2020 at 22:20)</a>:</h4>
<p>otherwise, the JSON output will be screwed</p>



<a name="218898698"></a>
<h4><a href="https://rust-lang.zulipchat.com#narrow/stream/266220-rustdoc/topic/warning%20sections%20in%20rustdoc%3A%20%2379677/near/218898698" class="zl"><img src="https://rust-lang.github.io/zulip_archive/assets/img/zulip.svg" alt="view this post on Zulip" style="width:20px;height:20px;"></a> Joshua Nelson <a href="https://rust-lang.github.io/zulip_archive/stream/266220-rustdoc/topic/warning.20sections.20in.20rustdoc.3A.20.2379677.html#218898698">(Dec 04 2020 at 22:20)</a>:</h4>
<p>'markdown compliant' doesn't mean a lot since all text is valid markdown <span aria-label="laughing" class="emoji emoji-1f606" role="img" title="laughing">:laughing:</span></p>



<a name="218898703"></a>
<h4><a href="https://rust-lang.zulipchat.com#narrow/stream/266220-rustdoc/topic/warning%20sections%20in%20rustdoc%3A%20%2379677/near/218898703" class="zl"><img src="https://rust-lang.github.io/zulip_archive/assets/img/zulip.svg" alt="view this post on Zulip" style="width:20px;height:20px;"></a> Joshua Nelson <a href="https://rust-lang.github.io/zulip_archive/stream/266220-rustdoc/topic/warning.20sections.20in.20rustdoc.3A.20.2379677.html#218898703">(Dec 04 2020 at 22:20)</a>:</h4>
<p>what do you mean by that?</p>



<a name="218898734"></a>
<h4><a href="https://rust-lang.zulipchat.com#narrow/stream/266220-rustdoc/topic/warning%20sections%20in%20rustdoc%3A%20%2379677/near/218898734" class="zl"><img src="https://rust-lang.github.io/zulip_archive/assets/img/zulip.svg" alt="view this post on Zulip" style="width:20px;height:20px;"></a> GuillaumeGomez <a href="https://rust-lang.github.io/zulip_archive/stream/266220-rustdoc/topic/warning.20sections.20in.20rustdoc.3A.20.2379677.html#218898734">(Dec 04 2020 at 22:21)</a>:</h4>
<p>it means not adding esoteric stuff like <code>§§ this is the warning §§</code></p>



<a name="218898763"></a>
<h4><a href="https://rust-lang.zulipchat.com#narrow/stream/266220-rustdoc/topic/warning%20sections%20in%20rustdoc%3A%20%2379677/near/218898763" class="zl"><img src="https://rust-lang.github.io/zulip_archive/assets/img/zulip.svg" alt="view this post on Zulip" style="width:20px;height:20px;"></a> GuillaumeGomez <a href="https://rust-lang.github.io/zulip_archive/stream/266220-rustdoc/topic/warning.20sections.20in.20rustdoc.3A.20.2379677.html#218898763">(Dec 04 2020 at 22:21)</a>:</h4>
<p>it has to remains fully readable even without the rustdoc nice renderin</p>



<a name="218898829"></a>
<h4><a href="https://rust-lang.zulipchat.com#narrow/stream/266220-rustdoc/topic/warning%20sections%20in%20rustdoc%3A%20%2379677/near/218898829" class="zl"><img src="https://rust-lang.github.io/zulip_archive/assets/img/zulip.svg" alt="view this post on Zulip" style="width:20px;height:20px;"></a> Nixon Enraght-Moony <a href="https://rust-lang.github.io/zulip_archive/stream/266220-rustdoc/topic/warning.20sections.20in.20rustdoc.3A.20.2379677.html#218898829">(Dec 04 2020 at 22:22)</a>:</h4>
<blockquote>
<p>Any sequence of characters is a valid CommonMark document.</p>
</blockquote>
<p><a href="https://spec.commonmark.org/0.29/#characters-and-lines">source</a></p>



<a name="218898889"></a>
<h4><a href="https://rust-lang.zulipchat.com#narrow/stream/266220-rustdoc/topic/warning%20sections%20in%20rustdoc%3A%20%2379677/near/218898889" class="zl"><img src="https://rust-lang.github.io/zulip_archive/assets/img/zulip.svg" alt="view this post on Zulip" style="width:20px;height:20px;"></a> GuillaumeGomez <a href="https://rust-lang.github.io/zulip_archive/stream/266220-rustdoc/topic/warning.20sections.20in.20rustdoc.3A.20.2379677.html#218898889">(Dec 04 2020 at 22:23)</a>:</h4>
<p>let's focus on "remains fully readable" please T_T</p>



<a name="218899062"></a>
<h4><a href="https://rust-lang.zulipchat.com#narrow/stream/266220-rustdoc/topic/warning%20sections%20in%20rustdoc%3A%20%2379677/near/218899062" class="zl"><img src="https://rust-lang.github.io/zulip_archive/assets/img/zulip.svg" alt="view this post on Zulip" style="width:20px;height:20px;"></a> GuillaumeGomez <a href="https://rust-lang.github.io/zulip_archive/stream/266220-rustdoc/topic/warning.20sections.20in.20rustdoc.3A.20.2379677.html#218899062">(Dec 04 2020 at 22:25)</a>:</h4>
<p><span class="user-mention" data-user-id="232545">@Joshua Nelson</span> On the meantime, I'm removing the second commit and the fcp since it doesn't have meaning anymore. Do you want to create the new issue or should I?</p>



<a name="218945294"></a>
<h4><a href="https://rust-lang.zulipchat.com#narrow/stream/266220-rustdoc/topic/warning%20sections%20in%20rustdoc%3A%20%2379677/near/218945294" class="zl"><img src="https://rust-lang.github.io/zulip_archive/assets/img/zulip.svg" alt="view this post on Zulip" style="width:20px;height:20px;"></a> Joshua Nelson <a href="https://rust-lang.github.io/zulip_archive/stream/266220-rustdoc/topic/warning.20sections.20in.20rustdoc.3A.20.2379677.html#218945294">(Dec 05 2020 at 17:52)</a>:</h4>
<p><span class="user-mention silent" data-user-id="232545">Joshua Nelson</span> <a href="#narrow/stream/266220-rustdoc/topic/warning.20sections.20in.20rustdoc.3A.20.2379677/near/218896492">said</a>:</p>
<blockquote>
<p>pulldown does not <em>parse</em> HTML</p>
</blockquote>
<p><span class="user-mention" data-user-id="132040">@Manish Goregaokar</span> you and I are saying different things when we say parse</p>



<a name="218945297"></a>
<h4><a href="https://rust-lang.zulipchat.com#narrow/stream/266220-rustdoc/topic/warning%20sections%20in%20rustdoc%3A%20%2379677/near/218945297" class="zl"><img src="https://rust-lang.github.io/zulip_archive/assets/img/zulip.svg" alt="view this post on Zulip" style="width:20px;height:20px;"></a> Manish Goregaokar <a href="https://rust-lang.github.io/zulip_archive/stream/266220-rustdoc/topic/warning.20sections.20in.20rustdoc.3A.20.2379677.html#218945297">(Dec 05 2020 at 17:52)</a>:</h4>
<p>ah</p>



<a name="218945304"></a>
<h4><a href="https://rust-lang.zulipchat.com#narrow/stream/266220-rustdoc/topic/warning%20sections%20in%20rustdoc%3A%20%2379677/near/218945304" class="zl"><img src="https://rust-lang.github.io/zulip_archive/assets/img/zulip.svg" alt="view this post on Zulip" style="width:20px;height:20px;"></a> Joshua Nelson <a href="https://rust-lang.github.io/zulip_archive/stream/266220-rustdoc/topic/warning.20sections.20in.20rustdoc.3A.20.2379677.html#218945304">(Dec 05 2020 at 17:52)</a>:</h4>
<p>I mean "tell the difference between classes and literal strings", you mean "put the literal string in the output"</p>



<a name="218945320"></a>
<h4><a href="https://rust-lang.zulipchat.com#narrow/stream/266220-rustdoc/topic/warning%20sections%20in%20rustdoc%3A%20%2379677/near/218945320" class="zl"><img src="https://rust-lang.github.io/zulip_archive/assets/img/zulip.svg" alt="view this post on Zulip" style="width:20px;height:20px;"></a> Manish Goregaokar <a href="https://rust-lang.github.io/zulip_archive/stream/266220-rustdoc/topic/warning.20sections.20in.20rustdoc.3A.20.2379677.html#218945320">(Dec 05 2020 at 17:53)</a>:</h4>
<p>sure</p>



<a name="218945328"></a>
<h4><a href="https://rust-lang.zulipchat.com#narrow/stream/266220-rustdoc/topic/warning%20sections%20in%20rustdoc%3A%20%2379677/near/218945328" class="zl"><img src="https://rust-lang.github.io/zulip_archive/assets/img/zulip.svg" alt="view this post on Zulip" style="width:20px;height:20px;"></a> Manish Goregaokar <a href="https://rust-lang.github.io/zulip_archive/stream/266220-rustdoc/topic/warning.20sections.20in.20rustdoc.3A.20.2379677.html#218945328">(Dec 05 2020 at 17:53)</a>:</h4>
<p>but it's part of the general point i'm making here: whatever the JSON backend is piped to will need to handle HTML regardless</p>



<a name="218945330"></a>
<h4><a href="https://rust-lang.zulipchat.com#narrow/stream/266220-rustdoc/topic/warning%20sections%20in%20rustdoc%3A%20%2379677/near/218945330" class="zl"><img src="https://rust-lang.github.io/zulip_archive/assets/img/zulip.svg" alt="view this post on Zulip" style="width:20px;height:20px;"></a> Manish Goregaokar <a href="https://rust-lang.github.io/zulip_archive/stream/266220-rustdoc/topic/warning.20sections.20in.20rustdoc.3A.20.2379677.html#218945330">(Dec 05 2020 at 17:53)</a>:</h4>
<p>Markdown _is_ HTML</p>



<a name="218945378"></a>
<h4><a href="https://rust-lang.zulipchat.com#narrow/stream/266220-rustdoc/topic/warning%20sections%20in%20rustdoc%3A%20%2379677/near/218945378" class="zl"><img src="https://rust-lang.github.io/zulip_archive/assets/img/zulip.svg" alt="view this post on Zulip" style="width:20px;height:20px;"></a> Joshua Nelson <a href="https://rust-lang.github.io/zulip_archive/stream/266220-rustdoc/topic/warning.20sections.20in.20rustdoc.3A.20.2379677.html#218945378">(Dec 05 2020 at 17:54)</a>:</h4>
<p>I guess the difference in my mind is that until now we haven't <em>recommended</em> using raw HTML in markdown</p>



<a name="218945383"></a>
<h4><a href="https://rust-lang.zulipchat.com#narrow/stream/266220-rustdoc/topic/warning%20sections%20in%20rustdoc%3A%20%2379677/near/218945383" class="zl"><img src="https://rust-lang.github.io/zulip_archive/assets/img/zulip.svg" alt="view this post on Zulip" style="width:20px;height:20px;"></a> Manish Goregaokar <a href="https://rust-lang.github.io/zulip_archive/stream/266220-rustdoc/topic/warning.20sections.20in.20rustdoc.3A.20.2379677.html#218945383">(Dec 05 2020 at 17:54)</a>:</h4>
<p>We have recommended markdown, raw html is allowed in markdown</p>



<a name="218945388"></a>
<h4><a href="https://rust-lang.zulipchat.com#narrow/stream/266220-rustdoc/topic/warning%20sections%20in%20rustdoc%3A%20%2379677/near/218945388" class="zl"><img src="https://rust-lang.github.io/zulip_archive/assets/img/zulip.svg" alt="view this post on Zulip" style="width:20px;height:20px;"></a> Manish Goregaokar <a href="https://rust-lang.github.io/zulip_archive/stream/266220-rustdoc/topic/warning.20sections.20in.20rustdoc.3A.20.2379677.html#218945388">(Dec 05 2020 at 17:54)</a>:</h4>
<p>we also haven't recommended using links in markdown :)</p>



<a name="218945391"></a>
<h4><a href="https://rust-lang.zulipchat.com#narrow/stream/266220-rustdoc/topic/warning%20sections%20in%20rustdoc%3A%20%2379677/near/218945391" class="zl"><img src="https://rust-lang.github.io/zulip_archive/assets/img/zulip.svg" alt="view this post on Zulip" style="width:20px;height:20px;"></a> Manish Goregaokar <a href="https://rust-lang.github.io/zulip_archive/stream/266220-rustdoc/topic/warning.20sections.20in.20rustdoc.3A.20.2379677.html#218945391">(Dec 05 2020 at 17:54)</a>:</h4>
<p><a href="https://spec.commonmark.org/0.29/#html-blocks">https://spec.commonmark.org/0.29/#html-blocks</a> &lt;-- part of the spec</p>



<a name="218945394"></a>
<h4><a href="https://rust-lang.zulipchat.com#narrow/stream/266220-rustdoc/topic/warning%20sections%20in%20rustdoc%3A%20%2379677/near/218945394" class="zl"><img src="https://rust-lang.github.io/zulip_archive/assets/img/zulip.svg" alt="view this post on Zulip" style="width:20px;height:20px;"></a> Manish Goregaokar <a href="https://rust-lang.github.io/zulip_archive/stream/266220-rustdoc/topic/warning.20sections.20in.20rustdoc.3A.20.2379677.html#218945394">(Dec 05 2020 at 17:54)</a>:</h4>
<p>i've seen crates using it</p>



<a name="218945404"></a>
<h4><a href="https://rust-lang.zulipchat.com#narrow/stream/266220-rustdoc/topic/warning%20sections%20in%20rustdoc%3A%20%2379677/near/218945404" class="zl"><img src="https://rust-lang.github.io/zulip_archive/assets/img/zulip.svg" alt="view this post on Zulip" style="width:20px;height:20px;"></a> Manish Goregaokar <a href="https://rust-lang.github.io/zulip_archive/stream/266220-rustdoc/topic/warning.20sections.20in.20rustdoc.3A.20.2379677.html#218945404">(Dec 05 2020 at 17:55)</a>:</h4>
<p>it gets used a _lot_ for images because markdown image syntax doesn't let you like ... resize them etc</p>



<a name="218945409"></a>
<h4><a href="https://rust-lang.zulipchat.com#narrow/stream/266220-rustdoc/topic/warning%20sections%20in%20rustdoc%3A%20%2379677/near/218945409" class="zl"><img src="https://rust-lang.github.io/zulip_archive/assets/img/zulip.svg" alt="view this post on Zulip" style="width:20px;height:20px;"></a> Manish Goregaokar <a href="https://rust-lang.github.io/zulip_archive/stream/266220-rustdoc/topic/warning.20sections.20in.20rustdoc.3A.20.2379677.html#218945409">(Dec 05 2020 at 17:55)</a>:</h4>
<p>so my perspective is that the ship has already sailed</p>



<a name="218945430"></a>
<h4><a href="https://rust-lang.zulipchat.com#narrow/stream/266220-rustdoc/topic/warning%20sections%20in%20rustdoc%3A%20%2379677/near/218945430" class="zl"><img src="https://rust-lang.github.io/zulip_archive/assets/img/zulip.svg" alt="view this post on Zulip" style="width:20px;height:20px;"></a> Joshua Nelson <a href="https://rust-lang.github.io/zulip_archive/stream/266220-rustdoc/topic/warning.20sections.20in.20rustdoc.3A.20.2379677.html#218945430">(Dec 05 2020 at 17:55)</a>:</h4>
<p>yeah that's fair - you're saying consumers of the JSON backend would need something like pandoc no matter what</p>



<a name="218945474"></a>
<h4><a href="https://rust-lang.zulipchat.com#narrow/stream/266220-rustdoc/topic/warning%20sections%20in%20rustdoc%3A%20%2379677/near/218945474" class="zl"><img src="https://rust-lang.github.io/zulip_archive/assets/img/zulip.svg" alt="view this post on Zulip" style="width:20px;height:20px;"></a> Joshua Nelson <a href="https://rust-lang.github.io/zulip_archive/stream/266220-rustdoc/topic/warning.20sections.20in.20rustdoc.3A.20.2379677.html#218945474">(Dec 05 2020 at 17:56)</a>:</h4>
<p>at least to display things the same as rustdoc</p>



<a name="218945475"></a>
<h4><a href="https://rust-lang.zulipchat.com#narrow/stream/266220-rustdoc/topic/warning%20sections%20in%20rustdoc%3A%20%2379677/near/218945475" class="zl"><img src="https://rust-lang.github.io/zulip_archive/assets/img/zulip.svg" alt="view this post on Zulip" style="width:20px;height:20px;"></a> Manish Goregaokar <a href="https://rust-lang.github.io/zulip_archive/stream/266220-rustdoc/topic/warning.20sections.20in.20rustdoc.3A.20.2379677.html#218945475">(Dec 05 2020 at 17:56)</a>:</h4>
<p>correct</p>



<a name="218945486"></a>
<h4><a href="https://rust-lang.zulipchat.com#narrow/stream/266220-rustdoc/topic/warning%20sections%20in%20rustdoc%3A%20%2379677/near/218945486" class="zl"><img src="https://rust-lang.github.io/zulip_archive/assets/img/zulip.svg" alt="view this post on Zulip" style="width:20px;height:20px;"></a> Manish Goregaokar <a href="https://rust-lang.github.io/zulip_archive/stream/266220-rustdoc/topic/warning.20sections.20in.20rustdoc.3A.20.2379677.html#218945486">(Dec 05 2020 at 17:57)</a>:</h4>
<p>there is _one_ crucial new thing we're introducing: so far unless they're using an external stylesheet, rustdoc markdown can just be rendered faithfully with a standard markdown parser with no frills</p>



<a name="218945489"></a>
<h4><a href="https://rust-lang.zulipchat.com#narrow/stream/266220-rustdoc/topic/warning%20sections%20in%20rustdoc%3A%20%2379677/near/218945489" class="zl"><img src="https://rust-lang.github.io/zulip_archive/assets/img/zulip.svg" alt="view this post on Zulip" style="width:20px;height:20px;"></a> Manish Goregaokar <a href="https://rust-lang.github.io/zulip_archive/stream/266220-rustdoc/topic/warning.20sections.20in.20rustdoc.3A.20.2379677.html#218945489">(Dec 05 2020 at 17:57)</a>:</h4>
<p>sure, the codeblocks will not look good, but they'll still exist</p>



<a name="218945495"></a>
<h4><a href="https://rust-lang.zulipchat.com#narrow/stream/266220-rustdoc/topic/warning%20sections%20in%20rustdoc%3A%20%2379677/near/218945495" class="zl"><img src="https://rust-lang.github.io/zulip_archive/assets/img/zulip.svg" alt="view this post on Zulip" style="width:20px;height:20px;"></a> Manish Goregaokar <a href="https://rust-lang.github.io/zulip_archive/stream/266220-rustdoc/topic/warning.20sections.20in.20rustdoc.3A.20.2379677.html#218945495">(Dec 05 2020 at 17:57)</a>:</h4>
<p>but the warning block will require additional css</p>



<a name="218945496"></a>
<h4><a href="https://rust-lang.zulipchat.com#narrow/stream/266220-rustdoc/topic/warning%20sections%20in%20rustdoc%3A%20%2379677/near/218945496" class="zl"><img src="https://rust-lang.github.io/zulip_archive/assets/img/zulip.svg" alt="view this post on Zulip" style="width:20px;height:20px;"></a> Manish Goregaokar <a href="https://rust-lang.github.io/zulip_archive/stream/266220-rustdoc/topic/warning.20sections.20in.20rustdoc.3A.20.2379677.html#218945496">(Dec 05 2020 at 17:57)</a>:</h4>
<p>i think this is a minor change</p>



<a name="218945504"></a>
<h4><a href="https://rust-lang.zulipchat.com#narrow/stream/266220-rustdoc/topic/warning%20sections%20in%20rustdoc%3A%20%2379677/near/218945504" class="zl"><img src="https://rust-lang.github.io/zulip_archive/assets/img/zulip.svg" alt="view this post on Zulip" style="width:20px;height:20px;"></a> Manish Goregaokar <a href="https://rust-lang.github.io/zulip_archive/stream/266220-rustdoc/topic/warning.20sections.20in.20rustdoc.3A.20.2379677.html#218945504">(Dec 05 2020 at 17:57)</a>:</h4>
<p>Now, there is also the whole other concern that from a user's POV they may not want to write HTML</p>



<a name="218945547"></a>
<h4><a href="https://rust-lang.zulipchat.com#narrow/stream/266220-rustdoc/topic/warning%20sections%20in%20rustdoc%3A%20%2379677/near/218945547" class="zl"><img src="https://rust-lang.github.io/zulip_archive/assets/img/zulip.svg" alt="view this post on Zulip" style="width:20px;height:20px;"></a> Manish Goregaokar <a href="https://rust-lang.github.io/zulip_archive/stream/266220-rustdoc/topic/warning.20sections.20in.20rustdoc.3A.20.2379677.html#218945547">(Dec 05 2020 at 17:58)</a>:</h4>
<p>but i'm iffy about that because introducing a one-liner syntax is fine until you want more than one line</p>



<a name="218945549"></a>
<h4><a href="https://rust-lang.zulipchat.com#narrow/stream/266220-rustdoc/topic/warning%20sections%20in%20rustdoc%3A%20%2379677/near/218945549" class="zl"><img src="https://rust-lang.github.io/zulip_archive/assets/img/zulip.svg" alt="view this post on Zulip" style="width:20px;height:20px;"></a> Manish Goregaokar <a href="https://rust-lang.github.io/zulip_archive/stream/266220-rustdoc/topic/warning.20sections.20in.20rustdoc.3A.20.2379677.html#218945549">(Dec 05 2020 at 17:58)</a>:</h4>
<p>and then it gets super complicated</p>



<a name="218945551"></a>
<h4><a href="https://rust-lang.zulipchat.com#narrow/stream/266220-rustdoc/topic/warning%20sections%20in%20rustdoc%3A%20%2379677/near/218945551" class="zl"><img src="https://rust-lang.github.io/zulip_archive/assets/img/zulip.svg" alt="view this post on Zulip" style="width:20px;height:20px;"></a> Joshua Nelson <a href="https://rust-lang.github.io/zulip_archive/stream/266220-rustdoc/topic/warning.20sections.20in.20rustdoc.3A.20.2379677.html#218945551">(Dec 05 2020 at 17:58)</a>:</h4>
<p><span class="user-mention silent" data-user-id="132040">Manish Goregaokar</span> <a href="#narrow/stream/266220-rustdoc/topic/warning.20sections.20in.20rustdoc.3A.20.2379677/near/218945486">said</a>:</p>
<blockquote>
<p>there is _one_ crucial new thing we're introducing: so far unless they're using an external stylesheet, rustdoc markdown can just be rendered faithfully with a standard markdown parser with no frills</p>
</blockquote>
<p>I think this is not actually different - the div will still show up without a stylesheet, it just won't look like a warning</p>



<a name="218945555"></a>
<h4><a href="https://rust-lang.zulipchat.com#narrow/stream/266220-rustdoc/topic/warning%20sections%20in%20rustdoc%3A%20%2379677/near/218945555" class="zl"><img src="https://rust-lang.github.io/zulip_archive/assets/img/zulip.svg" alt="view this post on Zulip" style="width:20px;height:20px;"></a> Manish Goregaokar <a href="https://rust-lang.github.io/zulip_archive/stream/266220-rustdoc/topic/warning.20sections.20in.20rustdoc.3A.20.2379677.html#218945555">(Dec 05 2020 at 17:58)</a>:</h4>
<p>correct</p>



<a name="218945566"></a>
<h4><a href="https://rust-lang.zulipchat.com#narrow/stream/266220-rustdoc/topic/warning%20sections%20in%20rustdoc%3A%20%2379677/near/218945566" class="zl"><img src="https://rust-lang.github.io/zulip_archive/assets/img/zulip.svg" alt="view this post on Zulip" style="width:20px;height:20px;"></a> Joshua Nelson <a href="https://rust-lang.github.io/zulip_archive/stream/266220-rustdoc/topic/warning.20sections.20in.20rustdoc.3A.20.2379677.html#218945566">(Dec 05 2020 at 17:59)</a>:</h4>
<p>which doesn't seem much different in practice than intra-doc links not showing up if you use a bog-standard markdown parser</p>



<a name="218945573"></a>
<h4><a href="https://rust-lang.zulipchat.com#narrow/stream/266220-rustdoc/topic/warning%20sections%20in%20rustdoc%3A%20%2379677/near/218945573" class="zl"><img src="https://rust-lang.github.io/zulip_archive/assets/img/zulip.svg" alt="view this post on Zulip" style="width:20px;height:20px;"></a> Manish Goregaokar <a href="https://rust-lang.github.io/zulip_archive/stream/266220-rustdoc/topic/warning.20sections.20in.20rustdoc.3A.20.2379677.html#218945573">(Dec 05 2020 at 17:59)</a>:</h4>
<p>it's different in that it's possible that the contents of the div may be written in a way that's unclear</p>



<a name="218945579"></a>
<h4><a href="https://rust-lang.zulipchat.com#narrow/stream/266220-rustdoc/topic/warning%20sections%20in%20rustdoc%3A%20%2379677/near/218945579" class="zl"><img src="https://rust-lang.github.io/zulip_archive/assets/img/zulip.svg" alt="view this post on Zulip" style="width:20px;height:20px;"></a> Manish Goregaokar <a href="https://rust-lang.github.io/zulip_archive/stream/266220-rustdoc/topic/warning.20sections.20in.20rustdoc.3A.20.2379677.html#218945579">(Dec 05 2020 at 17:59)</a>:</h4>
<p>unless it says WARNING</p>



<a name="218945580"></a>
<h4><a href="https://rust-lang.zulipchat.com#narrow/stream/266220-rustdoc/topic/warning%20sections%20in%20rustdoc%3A%20%2379677/near/218945580" class="zl"><img src="https://rust-lang.github.io/zulip_archive/assets/img/zulip.svg" alt="view this post on Zulip" style="width:20px;height:20px;"></a> Manish Goregaokar <a href="https://rust-lang.github.io/zulip_archive/stream/266220-rustdoc/topic/warning.20sections.20in.20rustdoc.3A.20.2379677.html#218945580">(Dec 05 2020 at 17:59)</a>:</h4>
<p>ah well i was hoping we  would eventually fix that in the json backend</p>



<a name="218945588"></a>
<h4><a href="https://rust-lang.zulipchat.com#narrow/stream/266220-rustdoc/topic/warning%20sections%20in%20rustdoc%3A%20%2379677/near/218945588" class="zl"><img src="https://rust-lang.github.io/zulip_archive/assets/img/zulip.svg" alt="view this post on Zulip" style="width:20px;height:20px;"></a> Joshua Nelson <a href="https://rust-lang.github.io/zulip_archive/stream/266220-rustdoc/topic/warning.20sections.20in.20rustdoc.3A.20.2379677.html#218945588">(Dec 05 2020 at 17:59)</a>:</h4>
<p><span class="user-mention silent" data-user-id="132040">Manish Goregaokar</span> <a href="#narrow/stream/266220-rustdoc/topic/warning.20sections.20in.20rustdoc.3A.20.2379677/near/218945580">said</a>:</p>
<blockquote>
<p>ah well i was hoping we  would eventually fix that in the json backend</p>
</blockquote>
<p>it works today I think</p>



<a name="218945591"></a>
<h4><a href="https://rust-lang.zulipchat.com#narrow/stream/266220-rustdoc/topic/warning%20sections%20in%20rustdoc%3A%20%2379677/near/218945591" class="zl"><img src="https://rust-lang.github.io/zulip_archive/assets/img/zulip.svg" alt="view this post on Zulip" style="width:20px;height:20px;"></a> Joshua Nelson <a href="https://rust-lang.github.io/zulip_archive/stream/266220-rustdoc/topic/warning.20sections.20in.20rustdoc.3A.20.2379677.html#218945591">(Dec 05 2020 at 18:00)</a>:</h4>
<p>at least, with some assembly</p>



<a name="218945639"></a>
<h4><a href="https://rust-lang.zulipchat.com#narrow/stream/266220-rustdoc/topic/warning%20sections%20in%20rustdoc%3A%20%2379677/near/218945639" class="zl"><img src="https://rust-lang.github.io/zulip_archive/assets/img/zulip.svg" alt="view this post on Zulip" style="width:20px;height:20px;"></a> Joshua Nelson <a href="https://rust-lang.github.io/zulip_archive/stream/266220-rustdoc/topic/warning.20sections.20in.20rustdoc.3A.20.2379677.html#218945639">(Dec 05 2020 at 18:00)</a>:</h4>
<p>it gives you which item the link refers to</p>



<a name="218945678"></a>
<h4><a href="https://rust-lang.zulipchat.com#narrow/stream/266220-rustdoc/topic/warning%20sections%20in%20rustdoc%3A%20%2379677/near/218945678" class="zl"><img src="https://rust-lang.github.io/zulip_archive/assets/img/zulip.svg" alt="view this post on Zulip" style="width:20px;height:20px;"></a> Joshua Nelson <a href="https://rust-lang.github.io/zulip_archive/stream/266220-rustdoc/topic/warning.20sections.20in.20rustdoc.3A.20.2379677.html#218945678">(Dec 05 2020 at 18:01)</a>:</h4>
<p><span class="user-mention silent" data-user-id="132040">Manish Goregaokar</span> <a href="#narrow/stream/266220-rustdoc/topic/warning.20sections.20in.20rustdoc.3A.20.2379677/near/218945504">said</a>:</p>
<blockquote>
<p>Now, there is also the whole other concern that from a user's POV they may not want to write HTML</p>
</blockquote>
<p>well right, from my perspective I don't think we're actually getting very much if it's just adding a stylesheet</p>



<a name="218945727"></a>
<h4><a href="https://rust-lang.zulipchat.com#narrow/stream/266220-rustdoc/topic/warning%20sections%20in%20rustdoc%3A%20%2379677/near/218945727" class="zl"><img src="https://rust-lang.github.io/zulip_archive/assets/img/zulip.svg" alt="view this post on Zulip" style="width:20px;height:20px;"></a> Joshua Nelson <a href="https://rust-lang.github.io/zulip_archive/stream/266220-rustdoc/topic/warning.20sections.20in.20rustdoc.3A.20.2379677.html#218945727">(Dec 05 2020 at 18:02)</a>:</h4>
<p>users still have to write HTML, you still have to worry about whether it renders properly with rustdoc's stylesheet, <em>and</em> you have this concern about other markdown parsers not rendering it correctly</p>



<a name="218945758"></a>
<h4><a href="https://rust-lang.zulipchat.com#narrow/stream/266220-rustdoc/topic/warning%20sections%20in%20rustdoc%3A%20%2379677/near/218945758" class="zl"><img src="https://rust-lang.github.io/zulip_archive/assets/img/zulip.svg" alt="view this post on Zulip" style="width:20px;height:20px;"></a> Manish Goregaokar <a href="https://rust-lang.github.io/zulip_archive/stream/266220-rustdoc/topic/warning.20sections.20in.20rustdoc.3A.20.2379677.html#218945758">(Dec 05 2020 at 18:03)</a>:</h4>
<p>you don't have to worry about it rendering properly with rustdoc's stylesheet</p>



<a name="218945766"></a>
<h4><a href="https://rust-lang.zulipchat.com#narrow/stream/266220-rustdoc/topic/warning%20sections%20in%20rustdoc%3A%20%2379677/near/218945766" class="zl"><img src="https://rust-lang.github.io/zulip_archive/assets/img/zulip.svg" alt="view this post on Zulip" style="width:20px;height:20px;"></a> Manish Goregaokar <a href="https://rust-lang.github.io/zulip_archive/stream/266220-rustdoc/topic/warning.20sections.20in.20rustdoc.3A.20.2379677.html#218945766">(Dec 05 2020 at 18:03)</a>:</h4>
<p>i do think the "users have to write HTML" is valid</p>



<a name="218945770"></a>
<h4><a href="https://rust-lang.zulipchat.com#narrow/stream/266220-rustdoc/topic/warning%20sections%20in%20rustdoc%3A%20%2379677/near/218945770" class="zl"><img src="https://rust-lang.github.io/zulip_archive/assets/img/zulip.svg" alt="view this post on Zulip" style="width:20px;height:20px;"></a> Manish Goregaokar <a href="https://rust-lang.github.io/zulip_archive/stream/266220-rustdoc/topic/warning.20sections.20in.20rustdoc.3A.20.2379677.html#218945770">(Dec 05 2020 at 18:03)</a>:</h4>
<p>but like, if we are introducing _any_ scoped syntax, they will have to learn it</p>



<a name="218945772"></a>
<h4><a href="https://rust-lang.zulipchat.com#narrow/stream/266220-rustdoc/topic/warning%20sections%20in%20rustdoc%3A%20%2379677/near/218945772" class="zl"><img src="https://rust-lang.github.io/zulip_archive/assets/img/zulip.svg" alt="view this post on Zulip" style="width:20px;height:20px;"></a> Manish Goregaokar <a href="https://rust-lang.github.io/zulip_archive/stream/266220-rustdoc/topic/warning.20sections.20in.20rustdoc.3A.20.2379677.html#218945772">(Dec 05 2020 at 18:03)</a>:</h4>
<p>anything other than <code>WARNING:</code> will be something with subtleties to learn</p>



<a name="218945825"></a>
<h4><a href="https://rust-lang.zulipchat.com#narrow/stream/266220-rustdoc/topic/warning%20sections%20in%20rustdoc%3A%20%2379677/near/218945825" class="zl"><img src="https://rust-lang.github.io/zulip_archive/assets/img/zulip.svg" alt="view this post on Zulip" style="width:20px;height:20px;"></a> Manish Goregaokar <a href="https://rust-lang.github.io/zulip_archive/stream/266220-rustdoc/topic/warning.20sections.20in.20rustdoc.3A.20.2379677.html#218945825">(Dec 05 2020 at 18:04)</a>:</h4>
<p>so my take is like this:</p>
<p>- HTML is strictly better than any ad hoc scoped syntax we introduce<br>
  - I'm not happy with it being unscoped and restricted to a single line</p>
<p>which makes my position "HTML or not at all"</p>



<a name="218945846"></a>
<h4><a href="https://rust-lang.zulipchat.com#narrow/stream/266220-rustdoc/topic/warning%20sections%20in%20rustdoc%3A%20%2379677/near/218945846" class="zl"><img src="https://rust-lang.github.io/zulip_archive/assets/img/zulip.svg" alt="view this post on Zulip" style="width:20px;height:20px;"></a> Joshua Nelson <a href="https://rust-lang.github.io/zulip_archive/stream/266220-rustdoc/topic/warning.20sections.20in.20rustdoc.3A.20.2379677.html#218945846">(Dec 05 2020 at 18:05)</a>:</h4>
<p>I'm on board with that take, I think that's reasonable</p>



<a name="218945851"></a>
<h4><a href="https://rust-lang.zulipchat.com#narrow/stream/266220-rustdoc/topic/warning%20sections%20in%20rustdoc%3A%20%2379677/near/218945851" class="zl"><img src="https://rust-lang.github.io/zulip_archive/assets/img/zulip.svg" alt="view this post on Zulip" style="width:20px;height:20px;"></a> Joshua Nelson <a href="https://rust-lang.github.io/zulip_archive/stream/266220-rustdoc/topic/warning.20sections.20in.20rustdoc.3A.20.2379677.html#218945851">(Dec 05 2020 at 18:05)</a>:</h4>
<p>so I think we should ask on <a href="https://github.com/rust-lang/rust/pull/79677">https://github.com/rust-lang/rust/pull/79677</a> if people will actually <em>use</em> it if it's HTML</p>



<a name="218945853"></a>
<h4><a href="https://rust-lang.zulipchat.com#narrow/stream/266220-rustdoc/topic/warning%20sections%20in%20rustdoc%3A%20%2379677/near/218945853" class="zl"><img src="https://rust-lang.github.io/zulip_archive/assets/img/zulip.svg" alt="view this post on Zulip" style="width:20px;height:20px;"></a> Joshua Nelson <a href="https://rust-lang.github.io/zulip_archive/stream/266220-rustdoc/topic/warning.20sections.20in.20rustdoc.3A.20.2379677.html#218945853">(Dec 05 2020 at 18:05)</a>:</h4>
<p>since otherwise there's not much point</p>



<a name="218945918"></a>
<h4><a href="https://rust-lang.zulipchat.com#narrow/stream/266220-rustdoc/topic/warning%20sections%20in%20rustdoc%3A%20%2379677/near/218945918" class="zl"><img src="https://rust-lang.github.io/zulip_archive/assets/img/zulip.svg" alt="view this post on Zulip" style="width:20px;height:20px;"></a> Joshua Nelson <a href="https://rust-lang.github.io/zulip_archive/stream/266220-rustdoc/topic/warning.20sections.20in.20rustdoc.3A.20.2379677.html#218945918">(Dec 05 2020 at 18:07)</a>:</h4>
<p>I can do that now if you like</p>



<a name="218951048"></a>
<h4><a href="https://rust-lang.zulipchat.com#narrow/stream/266220-rustdoc/topic/warning%20sections%20in%20rustdoc%3A%20%2379677/near/218951048" class="zl"><img src="https://rust-lang.github.io/zulip_archive/assets/img/zulip.svg" alt="view this post on Zulip" style="width:20px;height:20px;"></a> Manish Goregaokar <a href="https://rust-lang.github.io/zulip_archive/stream/266220-rustdoc/topic/warning.20sections.20in.20rustdoc.3A.20.2379677.html#218951048">(Dec 05 2020 at 20:06)</a>:</h4>
<p>I'll post something</p>



<a name="218986497"></a>
<h4><a href="https://rust-lang.zulipchat.com#narrow/stream/266220-rustdoc/topic/warning%20sections%20in%20rustdoc%3A%20%2379677/near/218986497" class="zl"><img src="https://rust-lang.github.io/zulip_archive/assets/img/zulip.svg" alt="view this post on Zulip" style="width:20px;height:20px;"></a> GuillaumeGomez <a href="https://rust-lang.github.io/zulip_archive/stream/266220-rustdoc/topic/warning.20sections.20in.20rustdoc.3A.20.2379677.html#218986497">(Dec 06 2020 at 13:14)</a>:</h4>
<p>I also think that HTML should enough (it's rare for me and <span class="user-mention" data-user-id="132040">@Manish Goregaokar</span> to agree hehe) but users seem to want a syntax extension too. So maybe we shouldn't close the possibility entirely and wait for them to agree on something (in the boundaries of something acceptable of course) and in the meatime, add the initial HTML we agreed on.</p>



<hr><p>Last updated: Aug 07 2021 at 22:04 UTC</p>
</html>